IntimateMerger Analytics Adapter : initial release by eknis · Pull Request #21 · IntimateMerger/Prebid.js

eknis · 2025-12-03T04:16:57Z

Type of change

Description of change

Other information

github-actions · 2025-12-03T04:19:31Z

Tread carefully! This PR adds 1 linter error (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+1 error)

github-actions · 2025-12-03T04:37:39Z

Tread carefully! This PR adds 1 linter error (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+1 error)

github-actions · 2025-12-03T06:41:22Z

Tread carefully! This PR adds 1 linter error (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+1 error)

fecker

ちともろもろ確認したいのと、意識合わせしたいです。

各社のAnalytics Adaptor は、bid の分析をもろもろしているのですが、
IMでは不要なので、そのあたりは調整が必要かなと。

今の実装ならキャッシュは不要な気がしつつ、バッファリング送信機能をつけるなら必要になるかなと思っています。

AUCTION_INIT
- cache の初期化（auctionId の管理用）
- Consent データの初期化（auctionId に紐づけて管理）
- pvデータのみを送信（ちょっと悩み中。データとして使わないなら、ぶっちゃけまとめて送ってもいいかも？調整中）
AUCTION_END
- setTimeout で遅延実行（800 ms くらい？）
  - cache[auctionId] に入ってるものを送る
  - cache[auctionId] で、データ送信フラグを管理
- setTimeout で遅延実行（3分後くらい？）
  - cache[auctionId] を削除する
    − SPA でたまらないようにする
BID_WON
- cache[auctionId] に情報を蓄積する
- データ送信済だったら（フラグがたってたら）全データを再送する

実装イメージ

case EVENTS.AUCTION_END:
  setTimeout(() => {
    analyticsAdapter.sendEvents(args.auctionId);
  }, BID_WON_WAIT); // 800ms ?
  break;

こんなことを書いてる Adaptor がいるので、バッファリングいけるんじゃないかと思ってます。

case EVENTS.BID_WON:
  const auction = cache.auctions[args.auctionId];
  if (!auction) return;

  // transactionId 単位で、cache するか
  // 配列に push した方が楽かもしれない

  // 再送を考えて、Timestamp も入れてもいいかも

  if (auction.sendStatus & REQUEST_SENT) { // すでに送信済だったら
     analyticsAdapter.sendEvents(args.auctionId); // 再送する
  }

みたいな感じでいけたりしないかなぁと思ってきました。

許諾のデータは、
libraries/intentIqUtils/getCmpData.js を参考にして
gdpr と usp (ccpa) だけとっておくと幸せになれるかなとおもってきました。

import { allConsent } from '../../src/consentHandler.js';

/**
 * Retrieves consent data from the Consent Management Platform (CMP).
 * @return {Object} An object containing the following fields:
 * - `gdprString` (string): GDPR consent string if available.
 * - `uspString` (string): USP consent string if available.
 * - `gppString` (string): GPP consent string if available.
 */
export function getCmpData() {
  const consentData = allConsent.getConsentData();

  return {
    gdprApplies: consentData?.gdpr?.gdprApplies || false,
    gdprString: typeof consentData?.gdpr?.consentString === 'string' ? consentData.gdpr.consentString : null,
    uspString: typeof consentData?.usp === 'string' ? consentData.usp : null,
    gppString: typeof consentData?.gpp?.gppString === 'string' ? consentData.gpp.gppString : null,
  };
}

modules/imAnalyticsAdapter.js

eknis · 2025-12-09T08:56:14Z

時刻 0ms:   AUCTION_INIT
            ↓ sendStatus = 0
時刻 100ms: BID_WON #1
            ↓ sendStatus & WON_SENT = 0 → キャッシュに追加
時刻 200ms: BID_WON #2
            ↓ sendStatus & WON_SENT = 0 → キャッシュに追加
時刻 300ms: AUCTION_END
            ↓ 800msタイマー開始
時刻 1100ms: sendWonBidsData() 実行
             ↓ BID_WON #1, #2 をまとめて送信
             ↓ sendStatus |= WON_SENT → sendStatus = 1
時刻 1500ms: BID_WON #3（遅延）
             ↓ sendStatus & WON_SENT = 1 → 即座に個別送信
時刻 2000ms: BID_WON #4（遅延）
             ↓ sendStatus & WON_SENT = 1 → 即座に個別送信

modules/imAnalyticsAdapter.js

github-actions · 2025-12-18T07:32:36Z

Tread carefully! This PR adds 2 linter errors (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+2 errors)

github-actions · 2025-12-19T02:55:44Z

Tread carefully! This PR adds 2 linter errors (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+2 errors)

github-actions · 2025-12-19T03:00:23Z

Tread carefully! This PR adds 2 linter errors (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+2 errors)

fecker

空いちゃってしません。直してリリースしましょう。

fecker · 2026-03-09T20:03:07Z

modules/imAnalyticsAdapter.js

+    gdprApplies: gdprConsent.gdprApplies,
+    gdpr: gdprConsent.consentString,


gdpr の consent はいらないかなと思ってきました・・・・（対応するつもりがほぼない）
他の adapter でやってたのですが gdpr に true / false （gdprApplies）を渡して、あげるのが幸せになれるかと思いました。

Suggested change

gdprApplies: gdprConsent.gdprApplies,

gdpr: gdprConsent.consentString,

gdpr: gdprConsent.gdprApplies ? 1 : 0,

と短くしてなるべく小さくした方が良さげかなと。

fecker · 2026-03-09T20:29:24Z

modules/imAnalyticsAdapter.js

+  return {
+    gdprApplies: gdprConsent.gdprApplies,
+    gdpr: gdprConsent.consentString,
+    usp: uspConsent


coppa も念の為取得しておいて頂けるとうれしいです。
coppa = Number(coppaDataHandler.getCoppa());

追記します

fecker · 2026-03-09T20:32:08Z

modules/imAnalyticsAdapter.js

+  const gdprConsent = request.gdprConsent || {};
+  const uspConsent = request.uspConsent;
+
+  return {


アメリカ・カナダがそこそこ入っていたので、
ggp: gppDataHandler.getConsentData().applicableSections; （Number が入ります）
ggpString: gppDataHandler.getConsentData().gppString;
で取得をお願いします。
（真面目にやるとここを見るのが良さげ？）

追加します

ごめんなさ。ガセだったっぽい・・・orz=3

fecker · 2026-03-09T20:33:53Z

modules/imAnalyticsAdapter.js

+
+        case EVENTS.AUCTION_END:
+          logMessage('IM Analytics: AUCTION_END', args);
+          this.scheduleWonBidsSend(args.auctionId);


細かいのですが、handleActionEnd() の方が良いのかなと思ったり。
で、その中で２つの処理を schedule するのが良いのでは？って思いました。

別のAdapterでやってたのですが、
（あまりユースケースはないかもですが、）Cache の肥大化対策をしてるものがいました。

一定時間後（5秒〜 10秒後）に、cache[auctions] をクリアする処理があってもいいかもす。

handleActionEndへ名称変更します

fecker · 2026-03-09T20:57:22Z

modules/imAnalyticsAdapter.js

+     * @param {Object} auctionArgs - Auction arguments
+     * @param {Object} consentData - Consent data object
+     */
+    handleAucInitData(auctionArgs, consentData) {


consentData って、auction の中でキャッシュされてるので、それを使いまわした方が良いのではと思ったのですが、どうすか？

handleAuction で、引数があわないのが気持ちわるい感じがします。

cacheから取得、引数が不要になるので修正します

modules/imAnalyticsAdapter.js

fecker · 2026-03-09T21:02:50Z

modules/imAnalyticsAdapter.js

+        return;
+      }
+
+      const consentData = auction.consentData || getConsentData(null);


cache からとるだけで大丈夫なんじゃないかなって思いました。

たしかにおかしなことにならないのでauction.consentDataからの取得でまとめました

fecker · 2026-03-09T21:04:03Z

modules/imAnalyticsAdapter.js

+     */
+    sendWonBidsData(auctionId) {
+      const auction = cache.auctions[auctionId];
+      if (!auction || !auction.wonBids || auction.wonBids.length === 0 || (auction.sendStatus & WON_SENT)) {


全部一緒に送ることを考えると最後の条件はいらないかなと。
（送れてきても、全部一緒に送ることで集計が楽になるはず）の

時刻 0ms: AUCTION_INIT ↓ sendStatus = 0 時刻 100ms: BID_WON #1 ↓ sendStatus & WON_SENT = 0 → キャッシュに追加時刻 200ms: BID_WON #2 ↓ sendStatus & WON_SENT = 0 → キャッシュに追加時刻 300ms: AUCTION_END ↓ 800msタイマー開始時刻 1100ms: sendWonBidsData() 実行 ↓ BID_WON #1, #2 をまとめて送信 ↓ sendStatus |= WON_SENT → sendStatus = 1 時刻 1500ms: BID_WON #3（遅延） ↓ sendStatus & WON_SENT = 1 → 即座に個別送信時刻 2000ms: BID_WON #4（遅延） ↓ sendStatus & WON_SENT = 1 → 即座に個別送信

これが今なんですが

時刻 0ms: AUCTION_INIT ↓ sendStatus = 0 時刻 100ms: BID_WON #1 ↓ sendStatus & WON_SENT = 0 → キャッシュに追加時刻 200ms: BID_WON #2 ↓ sendStatus & WON_SENT = 0 → キャッシュに追加時刻 300ms: AUCTION_END ↓ 800msタイマー開始時刻 1100ms: sendWonBidsData() 実行 ↓ BID_WON #1, #2 をまとめて送信時刻 1200ms: BID_WON #3 ↓ sendStatus & WON_SENT = 0 → キャッシュに追加時刻 1300ms: BID_WON #4 ↓ sendStatus & WON_SENT = 0 → キャッシュに追加時刻 1400ms: AUCTION_END ↓ 800msタイマー開始時刻 1500ms: sendWonBidsData() 実行 ↓ BID_WON #3, #4 をまとめて送信

この場合sendStatus,WON_SENT不要
みたいなかんじのほうが楽だよねってことであってますか

というか単純にここでチェックしなくても問題なくねという話ですかね

後者だと思って修正します

あれ・・・仕様は前者の認識です！（僕が間違ってたかも？）

次のPRに書いたのですが、ここを直すと、 sendIndividualWonBid がいらなくなる認識でした

modules/imAnalyticsAdapter.js

fecker

遅くなってすいません。リリースに向かいましょう。

fecker · 2026-03-10T02:24:54Z

modules/imAnalyticsAdapter.js

+function getConsentData(bidderRequests) {
+  if (!bidderRequests || !bidderRequests[0]) {
+    return EMPTY_CONSENT_DATA;
+  }
+


bidderRequests から取るより、Adapter から取得した方が分かりやすいかなと思ったのですが、どっちがいいっすかね・・？（0番目から取るよりという意味で。他のAnalytics Adapter はどうですか？）

bidderRequestsから取得しているところを見ていたんですが
最近はちゃんと主流になっていたので全体を見直してAdapter利用するように修正しました！

fecker · 2026-03-10T02:40:31Z

modules/imAnalyticsAdapter.js

+        timestamp,
+        wonBids: auction.wonBids


少しでも小さくと・・・ ts, bids あたりで良いかもです。

変更します！

fecker · 2026-03-10T02:41:06Z

modules/imAnalyticsAdapter.js

+
+const DEFAULT_BID_WON_TIMEOUT = 800; // 0.8 second for initial batch
+const DEFAULT_CID = 5126;
+const API_BASE_URL = 'https://b6.im-apps.net/bids';


（完全に趣味ですが）Prebid にあわせて、bid にしませんか？

bidにします！

…andlers into imAnalyticsAdapter

github-actions · 2026-03-26T07:55:32Z

Tread carefully! This PR adds 1 linter warning (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+1 warning)

fecker · 2026-03-30T00:10:14Z

modules/imAnalyticsAdapter.js

+    gdprApplies: gdprConsent.gdprApplies,
+    gdpr: gdprConsent.consentString,


Suggested change

gdprApplies: gdprConsent.gdprApplies,

gdpr: gdprConsent.consentString,

gdpr: gdprConsent.gdprApplies ? 1 : 0,

と短くしてなるべく小さくした方が良さげかなと。

fecker · 2026-03-30T00:16:59Z

modules/imAnalyticsAdapter.js

+  const gdprConsent = request.gdprConsent || {};
+  const uspConsent = request.uspConsent;
+
+  return {


ごめんなさ。ガセだったっぽい・・・orz=3

modules/imAnalyticsAdapter.js

fecker · 2026-03-30T00:41:12Z

modules/imAnalyticsAdapter.js

+
+      // If initial batch has been sent, send immediately
+      if (auction.sendStatus & WON_SENT) {
+        this.sendIndividualWonBid(auctionId, bidWonArgs, auction.consentData);


sendWonBidsData で送る（sendIndividualWonBid がいらなくなる）想定だったのですが、
だめでしたでしょうか？

pv, won の各送信処理は一箇所にまとめた方が良いかなと思いまして。

modules/imAnalyticsAdapter.js

fecker

すません。細かいですが・・・ bidReqeust （いっぱい）なので、結構削減

fecker · 2026-03-30T00:55:24Z

modules/imAnalyticsAdapter.js

+    transformAucInitData(auctionArgs) {
+      return {
+        ts: auctionArgs.timestamp,
+        adUnitCount: (auctionArgs.adUnits || []).length


Suggested change

adUnitCount: (auctionArgs.adUnits || []).length

adUnits: (auctionArgs.adUnits || []).length

なるべく小さく観点で減らしておきたいっす。

fecker · 2026-03-30T00:57:33Z

modules/imAnalyticsAdapter.js

+        pageUrl: window.location.href,
+        url: document.referrer || '',


Suggested change

pageUrl: window.location.href,

url: document.referrer || '',

url: window.location.href,

ref: document.referrer || '',

すんません。こっちのイメージでした w

あ、よかったですw

fecker

悩み相談。

fecker · 2026-03-30T00:59:47Z

modules/imAnalyticsAdapter.js

+import { EVENTS } from '../src/constants.js';
+import { sendBeacon } from '../src/ajax.js';
+
+const DEFAULT_BID_WON_TIMEOUT = 800; // 0.8 second for initial batch


悩み相談なのですが、ほんとにみんなこんなに早く返してるかな・・・
感覚値ですが 1500 でもいいかもと思ってきました・・・他はどうなんでしょうか・・・

アダプタータイムアウト値

33acrossAnalyticsAdapter 500ms

livewrappedAnalyticsAdapter 500ms

r2b2AnalyticsAdapter 500ms

imAnalyticsAdapter 800ms

ooloAnalyticsAdapter 1500ms

yandexAnalyticsAdapter 1500ms

pubmaticAnalyticsAdapter 2000ms

atsAnalyticsAdapter 2000ms

concertAnalyticsAdapter 3000ms

adxpremiumAnalyticsAdapter 3500ms

adkernelAdnAnalyticsAdapter 4000ms

こんな感じでした。
1500くらいでもいいかもしれません

eknis · 2026-03-30T12:22:23Z

ごめんなさ。ガセだったっぽい・・・orz=3

ここだけちょっとわからなかったですmm

fecker · 2026-03-31T02:11:17Z

ごめんなさ。ガセだったっぽい・・・orz=3

ここだけちょっとわからなかったですmm

Number 入ります！と宣言してましたが、
いまいち実装がよく分からんかった件す。（配列がきたりなど、もろもろみんな実装が違いすぎて・・・）

toString() しておけば安心かな〜と思いますｗ

fecker

細かいとこですが、ちょっとconsent も短くしたくなったです！

bidWonTimeout は、いったん、1500でいきましょうか。
（意外と、みんな長めに取ってるので、2000 でもいい気もしてきてますが・・・優柔不断）

その他は良さげです。

fecker · 2026-03-31T02:21:47Z

modules/imAnalyticsAdapter.js

+      this.handleAucInitData(args);
+    },
+
+    /**
+     * Handle auction init data - send immediately for PV tracking
+     * @param {Object} auctionArgs - Auction arguments
+     */
+    handleAucInitData(auctionArgs) {
+      const consentData = cache.auctions[auctionArgs.auctionId].consentData;
+      const payload = {
+        url: window.location.href,
+        ref: document.referrer || '',
+        ...this.transformAucInitData(auctionArgs),
+        consentData
+      };


Suggested change

this.handleAucInitData(args);

},

/**

* Handle auction init data - send immediately for PV tracking

* @param {Object} auctionArgs - Auction arguments

*/

handleAucInitData(auctionArgs) {

const consentData = cache.auctions[auctionArgs.auctionId].consentData;

const payload = {

url: window.location.href,

ref: document.referrer || '',

...this.transformAucInitData(auctionArgs),

consentData

};

this.handleAucInitData(args, consentData);

},

/**

* Handle auction init data - send immediately for PV tracking

* @param {Object} auctionArgs - Auction arguments

*/

handleAucInitData(args, consent) {

const payload = {

url: window.location.href,

ref: document.referrer || '',

...this.transformAucInitData(args),

consent

};

こっちは、cache からとるより、引数から渡した方が見通しが良いかなと思いました。

あと細かいですが、consentData も短くしちゃいましょうか！（bid request がどんくらいくるか怖くて・・・）

fecker · 2026-03-31T02:24:55Z

modules/imAnalyticsAdapter.js

+      const consentData = auction.consentData;
+      const ts = auction.auctionInitTimestamp || Date.now();
+
+      auction.wonSent = true;
+      auction.wonBidsTimer = null;
+      const bids = auction.wonBids;
+      auction.wonBids = [];
+
+      sendToApi(buildApiUrlWithOptions(this.options, 'won', auctionId), {
+        consentData,
+        ts,
+        bids
+      });


Suggested change

const consentData = auction.consentData;

const ts = auction.auctionInitTimestamp || Date.now();

auction.wonSent = true;

auction.wonBidsTimer = null;

const bids = auction.wonBids;

auction.wonBids = [];

sendToApi(buildApiUrlWithOptions(this.options, 'won', auctionId), {

consentData,

ts,

bids

});

const consent = auction.consentData;

const ts = auction.auctionInitTimestamp || Date.now();

auction.wonSent = true;

auction.wonBidsTimer = null;

const bids = auction.wonBids;

auction.wonBids = [];

sendToApi(buildApiUrlWithOptions(this.options, 'won', auctionId), {

bids,

ts,

consent,

});

こちらも、consent と短くしちゃいたいっす！

eknis · 2026-03-31T10:02:03Z

指摘いただいた点修正しました！
bidWonTimeoutは一つ前に修正してます

IntimateMerger Analytics Adapter : initial release

e73e918

IntimateMerger Analytics Adapter : sendBeacon

280a6d6

IntimateMerger Analytics Adapter : refactoring

0103771

IntimateMerger Analytics Adapter : fix sendBeacon

92606c4

eknis requested review from april418 and fecker December 4, 2025 07:11

eknis marked this pull request as ready for review December 4, 2025 07:11

IntimateMerger Analytics Adapter : update comment

0a7a285

fecker reviewed Dec 5, 2025

View reviewed changes

IntimateMerger Analytics Adapter : refactoring

8d67535

fecker reviewed Dec 17, 2025

View reviewed changes

eknis added 2 commits December 18, 2025 12:49

IntimateMerger Analytics Adapter : add test

18de1b7

IntimateMerger Analytics Adapter : refactoring

6042b68

IntimateMerger Analytics Adapter : update cache

a627e77

IntimateMerger Analytics Adapter : fix test

75c5bd7

eknis added 2 commits December 19, 2025 12:49

IntimateMerger Analytics Adapter : fix space

7fe1ad8

IntimateMerger Analytics Adapter :add md

e1ce492

eknis requested a review from fecker December 25, 2025 05:51

fecker reviewed Mar 9, 2026

View reviewed changes

fecker reviewed Mar 10, 2026

View reviewed changes

IntimateMerger Analytics Adapter : feat: Integrate new consent data h…

6a1d53d

…andlers into imAnalyticsAdapter

eknis requested a review from fecker March 26, 2026 07:55

fecker reviewed Mar 30, 2026

View reviewed changes

eknis added 2 commits March 30, 2026 21:08

IntimateMerger Analytics Adapter :refactoring params

0f7164a

IntimateMerger Analytics Adapter :update timeout

d2835f4

IntimateMerger Analytics Adapter :applicableSections.toString

0084a41

eknis requested a review from fecker March 30, 2026 12:26

fecker reviewed Mar 31, 2026

View reviewed changes

IntimateMerger Analytics Adapter :rename param

3ac1cf4

eknis requested a review from fecker March 31, 2026 10:02

		gdprApplies: gdprConsent.gdprApplies,
		gdpr: gdprConsent.consentString,

	gdprApplies: gdprConsent.gdprApplies,
	gdpr: gdprConsent.consentString,
	gdpr: gdprConsent.gdprApplies ? 1 : 0,

	adUnitCount: (auctionArgs.adUnits \|\| []).length
	adUnits: (auctionArgs.adUnits \|\| []).length

アダプター	タイムアウト値
33acrossAnalyticsAdapter	500ms
livewrappedAnalyticsAdapter	500ms
r2b2AnalyticsAdapter	500ms
imAnalyticsAdapter	800ms
ooloAnalyticsAdapter	1500ms
yandexAnalyticsAdapter	1500ms
pubmaticAnalyticsAdapter	2000ms
atsAnalyticsAdapter	2000ms
concertAnalyticsAdapter	3000ms
adxpremiumAnalyticsAdapter	3500ms
adkernelAdnAnalyticsAdapter	4000ms

Conversation

eknis commented Dec 3, 2025

Type of change

Description of change

Other information

Uh oh!

github-actions bot commented Dec 3, 2025

Uh oh!

github-actions bot commented Dec 3, 2025

Uh oh!

github-actions bot commented Dec 3, 2025

Uh oh!

fecker left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

eknis commented Dec 9, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Dec 18, 2025

Uh oh!

github-actions bot commented Dec 19, 2025

Uh oh!

github-actions bot commented Dec 19, 2025

Uh oh!

fecker left a comment

Choose a reason for hiding this comment

Uh oh!

fecker Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

fecker Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

fecker Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

eknis Mar 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

fecker Mar 9, 2026 •

edited

Loading

fecker Mar 9, 2026 •

edited

Loading

fecker Mar 9, 2026 •

edited

Loading

eknis Mar 26, 2026 •

edited

Loading